Place Bulk Orders

👋 Introduction

با استفاده از این قابلیت، می‌تونی چندین سفارش مختلف رو تنها با یک درخواست ثبت کنی.
این قابلیت برای زمانی که نیاز به ثبت چندین سفارش در یک بازار داری، خیلی کارآمده.

⚠️ Limitations

توجه

• حداکثر می‌تونی ۱۰ سفارش رو تو یک درخواست ثبت کنی.
• همه سفارش‌ها باید مربوط به یک بازار باشن.

🔗 Endpoint

POST /api/v1/odr/orders/bulk

⏱ Rate Limit

اطلاعیه

حداکثر تعداد درخواست‌های مجاز برای ثبت سفارش برابر با 1800 درخواست در ساعت هست.

📨 Request Example

curl --location --request POST 'https://api.bitpin.ir/api/v1/odr/orders/bulk' \  
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \  
--header 'Content-Type: application/json' \  
--data '[
    {
        "symbol": "USDT_IRT",
        "base_amount": 100,
        "price": 50000,
        "side": "buy",
        "type": "limit"
    },
    {
        "symbol": "USDT_IRT",
        "base_amount": 50,
        "price": 51000,
        "side": "buy",
        "type": "limit"
    }
]'

💬 Success Response

{
    "orders":[
        {  
            "id": 535179385,  
            "symbol": "PIXFI_IRT",  
            "type": "limit",  
            "side": "sell",  
            "price": "1956",  
            "stop_price": null,  
            "oco_target_price": null,  
            "base_amount": "63.0",  
            "quote_amount": "123228",  
            "identifier": null,  
            "state": "active",  
            "closed_at": null,  
            "created_at": "2024-07-29T14:07:34.176795+03:30",  
            "dealed_base_amount": "0",  
            "dealed_quote_amount": "0",  
            "req_to_cancel": false,  
            "commission": "1000"  
        },
        {  
            "id": 535179255,  
            "symbol": "PIXFI_IRT",  
            "type": "limit",  
            "side": "sell",  
            "price": "2000",  
            "stop_price": null,  
            "oco_target_price": null,  
            "base_amount": "80.0",  
            "quote_amount": "160000",  
            "identifier": null,  
            "state": "active",  
            "closed_at": null,  
            "created_at": "2024-07-29T14:07:34.176795+03:30",  
            "dealed_base_amount": "0",  
            "dealed_quote_amount": "0",  
            "req_to_cancel": false,  
            "commission": "1000"  
        }
    ]
}

اخطار

اگر یک یا چند سفارش در درخواست ناموفق باشند، کل درخواست با خطا مواجه شود. بنابراین، حتماً پارامترهای مربوط به هر سفارش را به دقت بررسی کنید.

توجه

• تمامی سفارش‌ها در این درخواست باید در یک بازار ثبت شوند.